;============================================================================
; Diese Funktion fügt die Daten eines anderen, bereits bestehenden Puffers,
; an der aktuellen Cursorposition des gewünschten Puffers ein. Dies ist von
; Nutzen, wenn viele Einzeldaten am Anfang eines Puffers eingefügt werden
; sollen, was nämlich je nach Menge der nach hinten zu schiebenden Daten eine
; sehr zeitraubende Angelegenheit werden kann. In solchen Fällen öffnen Sie
; einfach einen neuen Puffer, wo Sie die Daten dann fortlaufend (also immer
; ans Pufferende anfügend) speichern können, wobei nichts nach hinten gescho-
; ben werden muß. Ist das getan, dann verwenden Sie diese Funktion, um die
; Daten nun in Ihren eigentlichen Arbeitspuffer einzufügen, womit jetzt nur
; einmal die ganzen Restdaten verschoben werden müssen. Die Cursorposition
; wird automatisch nachgeführt, und steht nach dem Aufruf dementsprechend auf
; dem ersten Byte nach den eingefügten Daten.
;----------------------------------------------------------------------------
; Synopsis:    inserted = InsertBuf (BufHandle1, BufHandle2)
;                D0*                     A0          A1
;
; Eingaben:    A0 --> APTR auf den gewünschten Ziel-BufHandle
;              A1 --> APTR auf den zu verwendenden Quell-BufHandle
;
; Ergebnis:    D0 --> LONG - Anzahl der eingefügten Bytes
;                          - negativ, wenn Fehler (Info mit LastError())
;
; Bemerkung:   Diese Funktion löscht automatisch die Prozessor-Caches.
;
; Siehe auch:  SeekBuf(), Store(), InsertFile(), Replace(), Get(),
;              Clear()
;============================================================================